Skip to content

feat(docs): theme 2.0.0, the lighter blue accent, and a light/dark logo pair - #8

Merged
btravers merged 2 commits into
mainfrom
feat/theme-2-accent-logos
Aug 10, 2026
Merged

feat(docs): theme 2.0.0, the lighter blue accent, and a light/dark logo pair#8
btravers merged 2 commits into
mainfrom
feat/theme-2-accent-logos

Conversation

@btravers

Copy link
Copy Markdown
Contributor

Closes #6. Closes #7. Companion to btravstack/btravstack.github.io#43, which added di to the landing as the fifth panel and surfaced all three of these.

The accent — #2A62B8#3E7FD4

The original reasoning in custom.css stands and is kept: blue is plumbing, and the hex should be one the logo itself paints so chrome and artwork stay one color. Only the specific blue changes.

The landing paints each package name in the raw accent against a #100F12 card. Measured there:

dark card as pname on white
#3E7FD4 4.72 7.10 (AA)
#2A62B8 (what this file had) 3.22 ✗ 9.46
--pkg-temporal #6B76F2 5.00 6.75
--pkg-unthrown #3FB0A5 7.25 5.01

#2A62B8 is the logo's deep blue and lands well below the 5.00–7.25 the other four occupy. #3E7FD4 is the logo's lighter blue — the barrel rim, the plunger, the needle hub — so it is still a hex the mark already uses. It is --pkg-di in the theme, so this site and the landing panel now agree.

The logo pair

di was the only package shipping logo.svg alone. Three of its values read against the canvas rather than against the artwork:

element dark light
glass barrel #EAF2FB #2A2730
plunger head #2A62B8 #3E7FD4
needle shaft #9FB2C8 #5A6675

Left alone on a light background the near-white barrel washes out and the mark reads as a floating beet with a blue cap. logo-dark.svg is the existing file byte-for-byte — it was drawn for a near-black canvas. logo-light.svg inverts exactly those three and nothing else: the deep blue thumb rest and rod, the rim, the beet and the drop are untouched. The graduation ticks stay #3E7FD4 at 50%, landing at 1.89 against the dark barrel versus 1.81 against the light one, so they read equally faint either way.

Wired into the hero (index.md) and the nav logo (config.ts), matching entity. logo.svg remains the favicon and the JSON-LD organization mark.

The theme — 1.7.0 → 2.0.0

Where --pkg-di lives. The major is the removal of --pkg-demesne / --pkg-start; grepping this repo returns zero references to either, so nothing breaks.

One incidental: pnpm install recorded the new version as a pinned minimumReleaseAgeExclude entry ('@btravstack/theme@2.0.0'). I replaced it with the unversioned name plus the rationale comment entity and unthrown both use, so the next theme release needs no new entry. Only @btravstack/theme is listed — the other first-party @btravstack/* catalog entries can join it when they next bite, rather than changing policy for five packages in a docs PR.

No changeset: @btravstack/di itself is unchanged, and @btravstack/di-docs is private.

Verified

pnpm --filter @btravstack/di-docs build clean. In the emitted CSS: --accent: #3E7FD4, no 2a62b8 anywhere, all five --pkg-* tokens present and both retired tokens gone. Both logo variants screenshotted in both themes — hero and nav swap correctly.

…go pair

Three things the landing surfaced when di joined it as the fifth panel
(btravstack/btravstack.github.io#43). Closes #6. Closes #7.

**The accent.** `--accent` was `#2A62B8`, the logo's deep blue. The landing
paints each package name in the raw accent against a `#100F12` card, and that
hex measures 3.22 there — the other four packages sit at 5.00–7.25. It is now
`#3E7FD4`, the logo's *lighter* blue: 4.72 on the dark card, 7.10 as darkened
text on white. The original reasoning is untouched and still holds — blue is
plumbing, and the hex is one the mark itself already paints (barrel rim,
plunger, needle hub), so chrome and artwork stay one color.

**The logo pair.** di shipped only `logo.svg`, and it was the one package
without a `logo-{light,dark}` pair. Three of its values read against the canvas
rather than against the artwork, so on a light background the near-white barrel
washed out and the mark read as a floating beet with a blue cap. `logo-dark` is
the existing file unchanged; `logo-light` inverts exactly those three — barrel
`#EAF2FB`→`#2A2730`, plunger `#2A62B8`→`#3E7FD4`, needle `#9FB2C8`→`#5A6675`.
The ticks stay at 50% opacity: 1.89 against the dark barrel versus 1.81 against
the light one, so they read equally faint either way. The hero and the nav logo
now take the pair; `logo.svg` stays the favicon and the JSON-LD mark.

**The theme.** Catalog moves 1.7.0 → 2.0.0, which is where `--pkg-di` lives.
The major is the removal of `--pkg-demesne` / `--pkg-start`; neither is
referenced here, so nothing breaks. pnpm recorded the new version as a pinned
`minimumReleaseAgeExclude` entry — replaced with the unversioned name and the
rationale comment the other repos use, so the next release needs no entry.

Docs build clean: `--accent: #3E7FD4` in the emitted CSS, no `2a62b8` left, all
five `--pkg-*` tokens present and both retired ones gone, and both logo variants
verified in both themes.
Copilot AI lite review requested due to automatic review settings August 10, 2026 14:39

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the di documentation site’s visual identity to align with @btravstack/theme@2.0.0, switching the package accent to the logo’s lighter blue and introducing theme-aware logo assets for light/dark canvases.

Changes:

  • Bump @btravstack/theme from 1.7.02.0.0 and record a workspace policy exception for adopting that first-party config immediately.
  • Repoint the docs accent token from #2a62b8 to #3E7FD4 (the logo’s lighter blue).
  • Add logo-light.svg / logo-dark.svg and wire them into the VitePress home hero and navbar logo.

Reviewed changes

Copilot reviewed 4 out of 7 changed files in this pull request and generated no comments.

Show a summary per file
File Description
pnpm-workspace.yaml Bumps @btravstack/theme to 2.0.0 and adds minimumReleaseAgeExclude entry for @btravstack/theme.
pnpm-lock.yaml Updates lockfile to reflect @btravstack/theme@2.0.0.
docs/public/logo-light.svg Adds light-canvas logo variant with inverted canvas-dependent fills.
docs/public/logo-dark.svg Adds dark-canvas logo variant for theme-aware swapping.
docs/index.md Switches hero image to use light/dark logo variants.
docs/.vitepress/theme/custom.css Updates --accent to #3E7FD4 and expands rationale comment.
docs/.vitepress/config.ts Switches navbar logo config to light/dark variants.
Files not reviewed (1)
  • pnpm-lock.yaml: Generated file

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

`pnpm format --check` failed CI on this file. oxfmt normalises CSS hex values
to lowercase, which is why every sibling site's `--accent` is lowercase and why
this file's own `#2a62b8` was before it changed. The comment's hex follows, so
the file does not mix cases with its own declaration.

Note this is the opposite of the markdown convention: prose in changesets and
`design.md` writes hexes uppercase. Each file type is internally consistent.

Root cause of the miss: the shared pre-commit hook in @btravstack/lefthook
globs `*.{ts,tsx,js,jsx,json,yaml,yml,md}`, which has no `css`, so this file was
never formatted locally — the hook reported three files (config.ts, index.md,
pnpm-workspace.yaml) and skipped this one. CI runs `oxfmt .` over everything.
@btravers
btravers merged commit e4ef06e into main Aug 10, 2026
13 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: ship logo-light.svg / logo-dark.svg, as the other packages do feat(docs): repoint the accent to the logo's lighter blue

2 participants